container: Deprecate focus chains

diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c
index 0900782fb9de58a64573e9da3d445ca6d69346ca..88f1fc415e195e354a090e3b4597962108361eb3 100644 (file)
--- a/gtk/gtkcontainer.c
+++ b/gtk/gtkcontainer.c
@@ -3340,6 +3340,9 @@ chain_widget_destroyed (GtkWidget *widget,
  * to set the focus chain before you pack the widgets, or have a widget
  * in the chain that isn’t always packed. The necessary checks are done
  * when the focus chain is actually traversed.
+ *
+ * Deprecated: 3.24: For overriding focus behavior, use the
+ *     GtkWidgetClass::focus signal.
  **/
 void
 gtk_container_set_focus_chain (GtkContainer *container,
@@ -3404,6 +3407,9 @@ gtk_container_set_focus_chain (GtkContainer *container,
  *
  * Returns: %TRUE if the focus chain of the container
  * has been set explicitly.
+ *
+ * Deprecated: 3.24: For overriding focus behavior, use the
+ *     GtkWidgetClass::focus signal.
  **/
 gboolean
 gtk_container_get_focus_chain (GtkContainer *container,
@@ -3431,6 +3437,9 @@ gtk_container_get_focus_chain (GtkContainer *container,
  * @container: a #GtkContainer
  *
  * Removes a focus chain explicitly set with gtk_container_set_focus_chain().
+ *
+ * Deprecated: 3.24: For overriding focus behavior, use the
+ *     GtkWidgetClass::focus signal.
  **/
 void
 gtk_container_unset_focus_chain (GtkContainer  *container)

diff --git a/gtk/gtkcontainer.h b/gtk/gtkcontainer.h
index ea87bd91c80d160a8d4a133e59a1799fcad800c8..70a429bcf70c132afa8b80e9b7997f06e7f2e11c 100644 (file)
--- a/gtk/gtkcontainer.h
+++ b/gtk/gtkcontainer.h
@@ -172,13 +172,13 @@ void     gtk_container_propagate_draw   (GtkContainer   *container,
                                         GtkWidget      *child,
                                         cairo_t        *cr);
 
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_24
 void     gtk_container_set_focus_chain  (GtkContainer   *container,
                                          GList          *focusable_widgets);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_24
 gboolean gtk_container_get_focus_chain  (GtkContainer   *container,
                                         GList         **focusable_widgets);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_24
 void     gtk_container_unset_focus_chain (GtkContainer  *container);
 
 #define GTK_IS_RESIZE_CONTAINER(widget) (GTK_IS_CONTAINER (widget) && \